home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / qwfind10.zip / QWFIND.DOC < prev    next >
Text File  |  1991-11-03  |  6KB  |  129 lines
  1.  
  2.  
  3.                     QWord Finder and QWord Find and Replace
  4.                         Version 1.0, November 1, 1991
  5.                      Copyright (C) 1991 by Steve Petermann
  6.                             all rights reserved
  7.  
  8.  
  9.      Description:
  10.      ------------
  11.      "QWord Finder" and "QWord Find and Replace" are shell programs to
  12.      find, view, and/or replace words across files and across
  13.      subdirectories. They use Borland's Grep.com to find the files with
  14.      matching words and then use Qmac and Sammy Mitchell's excellent
  15.      QEdit to view and/or replace the words.  They were designed
  16.      especially for programmers who need to change symbol names across
  17.      many files and directories.  Since viewing and replacement occurs
  18.      within QEdit, you have complete control over the process.
  19.  
  20.      Usage:
  21.      ------
  22.      To use the programs you will need q.exe(ver 2.1 or later),
  23.      qmac.exe and Borland's grep.com in the path of your computer.
  24.      QMac.exe is the macro compiler for QEdit and can be found on many
  25.      bulletin boards or QEdit's board at 1-404-641-8968. Borland's
  26.      grep is used because it allows searching subdirectories. It is
  27.      bundled with Borland's language products. Input fields include:
  28.  
  29.         1) Find:  The search pattern to find. This is a pattern of
  30.            letters and symbols to be found.  It can be a single letter,
  31.            a word or a string of words up to 59 characters(QEdit limit).
  32.  
  33.         2) Put:  What to replace it with(QWord Find and Replace).  This
  34.            is a letter, word or string of words up to 59 characters.
  35.  
  36.         3) Path:  The search path.  The drives, directories, file
  37.            names and extensions to search through.  Multiple paths
  38.            should be separated by a space.  You can use wildcards as
  39.            needed. If you don't specify a directory in the path, the
  40.            current directory is searched.  This entry can be up to 96
  41.            characters, but it's length may cause the grep search
  42.            pattern to be clipped(will be shown in the Find field).
  43.            This is because of the DOS 128 byte command line limit. The
  44.            search pattern that QEdit uses will, however, not be
  45.            clipped.
  46.  
  47.            Example: Path: *.  *.c  *.h  c:\bin\test\test.c d:\assem\*.asm
  48.  
  49.         4) Mode:  Search Options.
  50.            Defaults are non-word, case sensitive, current directory only
  51.            Options available are:
  52.               'w'  For word search
  53.               'i'  To ignore case
  54.               'd'  To search the subdirectories on the specified paths.
  55.                    With this option, if you don't specify any
  56.                    directories, the search will start at the current
  57.                    directory and proceed to its subdirectories.
  58.  
  59.  
  60.      Command Line Input:
  61.      -------------------
  62.      Input for the search path and search options can be entered at the
  63.      command line.  This can be useful for setting up batch files with
  64.      default options(see wf.bat and wfr.bat). The search options are
  65.      preceded by a '-'.  Multiple search paths are separated by a space.
  66.  
  67.      Examples:  qwf -wid *.cpp *.hpp
  68.                 qwfr -i *.c *.h *.asm *.inc
  69.  
  70.      Use a ? on the command line to show the usage.(qwf ?) or (qwfr ?).
  71.  
  72.  
  73.      Editing:
  74.      --------
  75.      The normal editing keys(arrows, home, end , delete, etc) and some
  76.      of the WordStar type control commands(Ctr-S, Ctrl-D, etc) can be
  77.      used for editing fields. An exception is that Ctrl-A positions
  78.      the cursor at the beginning of the string and Ctrl-F at the end
  79.      of the string. The return, tab, back tab, up arrow, down arrow,
  80.      Ctrl-E, Ctrl-C allow movement between fields.  All entries are
  81.      accepted after the mode field is completed.
  82.  
  83.  
  84.      Registration:
  85.      -------------
  86.      If you find these programs are useful to you, a registration of
  87.      $10.00 would be appreciated.  Send to:
  88.  
  89.                            Steve Petermann
  90.                            3100 Lemmontree Ln.
  91.                            Plano, Texas 75074
  92.  
  93.      Comments and suggestions are welcome.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.      DISCLAIMER - AGREEMENT
  100.  
  101.      Users of QWord Finder and QWord Find and Replace must accept this
  102.      disclaimer of warranty: QWord Finder and QWork Find and Replace
  103.      are supplied as is.  The author disclaims all warranties,
  104.      expressed or implied, including, without limitation, the
  105.      warranties of merchantability and of fitness for any purpose. The
  106.      author assumes no liability for damages, direct or consequential,
  107.      which may result from the use of QWord Finder and QWord Find and
  108.      Replace.
  109.  
  110.      Commercial users of QWord Finder and QWord Find and Replace must
  111.      register and pay for their copies of QWord Finder and QWord Find
  112.      and Replace within 30 days of first use or their license is
  113.      withdrawn. Site-License arrangements may be made by contacting
  114.      Steve Petermann.
  115.  
  116.      Anyone distributing QWord Finder and QWord Find and Replace for
  117.      any kind of remuneration must first contact Steve Petermann at
  118.      the address above for authorization.
  119.  
  120.      You are encouraged to pass a copy of QWord Finder and QWord Find
  121.      and Replace along to your friends for evaluation.  Please
  122.      encourage them to register their copy if they find that they can
  123.      use it.
  124.  
  125.  
  126.      QEdit is a registered trademark of Applied Systems Technologies, Inc.
  127.      WordStar is a registered trademark of WordStar International Inc.
  128.  
  129.